MACD 5

home *** CD-ROM | disk | FTP | other *** search

/ MACD 5 / MACD 5.bin / workbench / commodity / spaceii / space.help < prev next >

Wrap

Text File | 1992-08-20 | 26.9 KB | 823 lines

************************************************************************** S P A C E I I Copyright (C)1991 Edgar M. Vigdal ************************************************************************** This program is a sharware program, so if you use this program, or have it in your collection of public-domain, you MUST send $20 to : EDGAR M. VIGDAL Bjørkelund 5830 LUSTER NORWAY You will then become a registered user and receive new versions and other utilities that I have made. ************************************************************************** ************************************************************************** ** ** ** THIS IS A BETA VERSION OF THE 2.3 VERSION. THE TEXT VIEWER/EDITOR ** ** IS JUST HALF FINISHED, SO IT MAY BE A BIT BUGGY. ** ** ** ************************************************************************** ========================================================================== -------------------------------------------------------------------------- SPACE II -------------------------------------------------------------------------- ========================================================================== The Screen Blanking Utility. Version 2.3 Beta Release date 8/5-92. This program started out as a simple screen blanking program, but now in it's latest version (v2.3) it has over 50 utilities built in to only 55 Kbytes of pure assembler code. The program is a resident utility that will be placed in the background, and will be activated with keypresses. The program was made as small as possible, so that the tiny memory it occupies can be justified by the usefulness of the many utilities it provides. The program uses a inputhandler for linking into the stream of input events, and is almost invisible for other programs. The time I have used it, no interference with other program has occurred, but if you discover some bugs than PLEASE let me know !!!. If you have ideas for more short utilities that you would have liked to see inside it, then send me a description of the utility and I will try to work it out. List of current utilities: (No specific order) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1. Five different Screen blankers. - Star field - Lines (kaleidoscope) - 3D Clock - Colour dimmer - Black screen 6. Mouse blanker. 7. Text viewer. (soon text editor) ALT/SHIFT/CTRL READ 8. Hex dump of files. ALT/SHIFT/CTRL READ 9. IFF-picture viewer. ALT/SHIFT/CTRL VIEW IFF 10. Sound player. ALT/SHIFT/CTRL SOUND 11. Make new directory. ALT/SHIFT/CTRL MAKEDIR 12. Rename files. ALT/SHIFT/CTRL RENAME 13. Move files. ALT/SHIFT/CTRL MOVE 14. Copy files. ALT/SHIFT/CTRL COPY 15. Delete files. ALT/SHIFT/CTRL DELETE 16. Set protection flags. ALT/SHIFT/CTRL <HSPARWED> 17. Program runner. ALT/SHIFT/CTRL RUN 18. Text printer. ALT/SHIFT/CTRL READ Shift P 19. Directory lister. ALT/SHIFT/CTRL DIR 20. Filename and path injection. ALT/SHIFT/CTRL FILEPATH --> 21. Filename injection. ALT/SHIFT/CTRL FILENAME --> 22. Disk copy. ALT/SHIFT/CTRL DISK COPY 23. Disk formater. ALT/SHIFT/CTRL FORMAT 24. Directory to printer. ALT/SHIFT/CTRL DIR > PRT ALT/CTRL D 25. Set blanking time. ALT/CTRL T 26. Keyboard macro. ALT/CTRL M 27. NewCli. ALT/CTRL C 28. DOS command/program executer. ALT/CTRL R 29. Font viewer. ALT/CTRL F 30. Device info. ALT/CTRL F1 31. Memory info. ALT/CTRL F2 32. Palette. ALT/CTRL F3 33. Copy Files. ALT/CTRL F4 34. Calculator. ALT/CTRL F5 35. Mouse Blanker OFF. ALT/CTRL F6 36. Mouse Blanker ON. ALT/CTRL F7 37. Screen dumper. ALT/CTRL F8 38. Alarm. ALT/CTRL F9 39. Save screens as IFF-pictures. ALT/CTRL F10 40. Audio filter On/Off. ALT/CTRL * (Keypad) 41. 50/60Hz Switch. ALT/CTRL / (Keypad) 42. Text rescue. ALT/CTRL ENTER (Keypad) 43. Display boot-block on disks in DF0:. ALT/CTRL 4 (Keypad) 44. Install disk in DF0. ALT/CTRL 5 (Keypad) 45. UnInstall disks in DF0:. ALT/CTRL 6 (Keypad) 46. Set blanking mode. ALT/CTRL . (Keypad) 47. Disable/Enable vector checker ALT/CTRL BACKSPACE... 48. Exec Vectors display. ALT/CTRL BACKSPACE 49. Virus checker. 50. Screen shuffler with activate. ALT/CTRL CRSR UP 51. Screen shuffler without activate. ALT/CTRL CRSR DOWN 52. Window shuffler, Front to back. ALT/CTRL CRSR LEFT 53. Window shuffler, Back to Front. ALT/CTRL CRSR RIGHT in 54452 bytes. MENU ALT/SHIFT/CTRL ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When pressing the three keys <LEFT ALT> + <LEFT SHIFT> + CTRL, a menu will be opened up on the screen you are currently working on. From the menu you can select the following utilities. RUN This will try to start up a selected program and run it as a new task. You can also input arguments to the new program. MAKEDIR This will prompt for the name of the new directory and then attempt to create the new directory. DELETE This will delete the selected file/files. If you have selected multiple files in the file- requester, all of the selected files will now be deleted. Before each delete you will be asked to confirm the operation. RENAME This will prompt for a new name and than rename the selected file. DIR This will bring up the filerequester and a new file can be selected. You can select multiple files by holding down SHIFT and selecting filenames by clicking once on the name. You can also use the match function to filter out the files you want to do something to. The DIR function will always discard any files that you have selected with the multiple function and not yet got any info on. D This will examine the next file IF you have selected more than one file in the filerequester. DIR > PRT This will send a selected directory to the printer, or a file that you choose. COPY This will make a copy of the file/files you have selected with the filerequester. It will ask you to select a destination directory for the files. MOVE This will move the file/files you have selected with the filerequester. It will ask you to select a destination directory for the files. FILEPATH --> This will send the filename with the path into the document/CLI you stood in when activating Space II. Examples: 1. If you are working with a source code for some program and you want to include a data file into it. You than place the cursor where you want the filename, and then press ALT/SHIFT/CTRL and then click the DIR gadget and find the wanted file. when you now click on the "FILEPATH -->", the whole filepath will be typed into your source code. 2. You want to start a program, but don't remember the path and the filename. Just press the three magic keys and find the program with the filerequester, then click on "FILEPATH -->". Now you can start the program with pressing the RETURN key (easy ehhh?) FILENAME --> This will send the filename into the document/CLI you stood in when activating Space II. This will work just like the 'FILEPATH -->' function, but will only send the filename for the file you have selected. READ This will load a ascii text or a PowerPacked document and display it. You can also use it to read programs, text or any files in hex dump. Press <H> to enter hex mode. (Press HELP for instructions on the text-viewer.) If you have selected multiple files, you can read the next file by opening a new text (O, Both MButtons) VIEW IFF This will load and display a IFF-picture. If you have selected a animation the first frame in the anim. will be displayed. If you have selected more than one file, you can view the next file by pressing any of the mousebuttons, or F1. This function can NOT load DynamicHAM pictures. SOUND This will load and play any IFF/RAW samples. HELP This will load the help text (This text.) DISKCOPY This will make a copy of a disk in DF0: This function is a bit simple, but it works. Next version will hopefully support more drives. FORMAT This will format a disk in drive DF0:. You can format it in two ways. 1) If the disk is new and unused then use the STANDARD format. This will format the disk in a standard Amiga format. 2) If the disk as previously been formated on the Amiga, you can use the QUICK format. All data on the disk will be lost when you format a disk, so be careful! You can also set the protection bits <HSPARWED> for a file by clicking on the protection gadgets. H Hidden S Script P Pure A Archived R Read W Write E Edit D Delete You can close the menu by pressing ESC or clicking on the OK gadget. IFF VIEWER ALT/CTRL F1, VIEW IFF ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When you are viewing a picture, you can adjust the palette for the picture by pressing F3 or you can dump the picture to the printer by pressing F8. You must of course have a printer connected and a printer driver selected. By pressing F1 you can load another picture. If you have selected more then one picture in the filerequester, you can view the next be clicking the left mousebutton. Animations will be loaded, but only the first frame will be displayed. ESC or mousebuttons to exit. FILE RUNNER/DOS COMMAND ALT/CTRL D ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will open up a string input box where you can enter the wanted DOS command or the name of a program you want to start. You can also provide any arguments to the command/program. Example: NewShell (Create a newshell window) List df0: to * (List the directory on df0: to *) A output window for the SPACE II will now be opened. This will be used to output any error messages that the command/program generated. The command/program will spin off, creating a new task and hopefully the program will start. TEXT VIEWER ALT/SHIFT/CTRL READ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will load a text and display it in a window. The text viewer has some advanced options. It has very fast text scrolling and very fast searching after text in the document. (It scans through ca. 125000 chars pr. second on a standard Amiga 2000B). It can also load PowerPacked docs. The text viewer can also be used as a hex dump viewer, so any files can be loaded and viewed. Here is a list of commands for the textviewer: (use right Amiga key) O Open a new file. This will close the current file and load a new file. Any type of file can be loaded (Text, Docs, Data...). P Print page. Print the page that is currently displayed. Output can be directed to any device and can be printed as draft, NLQ or plain text. Press ESC to stopp the printout. P + Shift Print all. Same as P, but prints the whole file. A Search backward. S Search forward. A, S + Shift Enter search text and search for it. G Goto line. H Toggles HEX and standard output mode. ` (Over TAB) This will toggle the interlaced display. T 7(HOME) Goto top of text. E 1(END) Goto end of text. 8 (Keypad) Goto first mark. 5 (Keypad) Goto second mark. 2 (Keypad) Goto third mark. 8 5 3 + Shift Set first, second and third mark. CRSR UP Previous line. CRSR DOWN Next line. SHIFT CRSR U D Previous/Next page of text. Both mousebuttons to open a new text. Pointer over middle of screen and left mousebutton, to scroll up. Pointer under middle of screen and left mousebutton, to scroll down. F6 Palette requester. F10 Toggle ON/OFF the scrollbar. You can also open a new file by pressing ALT/SHIFT/CTRL. If you have already opened a text, the text viewer window will be closed and the file requester will be displayed. NB ** You must have the 'powerpacker.library' in the LIBS: directory for loading power packed docs/texts. DEVICE INFO ALT/CTRL F1 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will show what devices (disks, harddisks, ramdisks) that are in the system. The disks total size, how much free space there are one each device and any errors. MEMORY INFO ALT/CTRL F2 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will display the amount of random access memory (RAM) in you system. It will show both Chip-RAM and Fast-RAM, and the locations for both. The greatest blocks of free continues memory is also displayed. PALETTE ALT/CTRL F3 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will bring up a palette, so you may adjust the colours on the current screen. FILE COPY ALT/CTRL F4 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This is a simple file copying utility. You use the filerequester to choose the file/files to copy and click on the 'OK' gadget and then select the destination directory and confirm the copy. CALCULATOR ALT/CTRL F5 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ How many times have you needed a calculator and looked all over for it. Well now it's just a keypress away. It is a bit simple, but it has bin, oct, hex and decimal and the answer can be transferred into your editor or another program as if you had typed it in yourself. You could use the key pad for entering numbers and F1-F3 for selecting bin-decimal. CRSR RIGHT is transfer and [ is CLEAR ALL. A-F for Hex numbers. ESC for quit. ************************************************************* If anybody have a good source for converting floating point numbers into an ASCII string, and ASCII strings into floating point numbers, then please contact me !!!!!!!!!!! The source must be in assembler code. POINTER BLANKER OFF ALT/CTRL F6 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will disable the pointer blanking and restore the pointer. The pointer blanker will remove the pointer from the screen when a key is pressed and display it again when the mouse is moved. POINTER BLANKER ON ALT/CTRL F7 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will enable the pointer blanking. SCREEN DUMP ALT/CTRL F8 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will dump the current screen to the printer. It uses the preferences, so the density and colour/gray scale will depend on the selections made in the preferences. The screen dump may take some time to perform, so be patient. ALARM ALT/CTRL and F9 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will prompt for a time (minutes) and a message that shall be displayed when the time has passed. The message can be up to 80 characters long. The message can be displayed as many lines, by using CTRL + J as linefeed in the string. The alarm can be switched OFF by entering 0 as the time. IFF-PICTURE SAVER ALT/CTRL and F10 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will save the first screen as an IFF-picture. It will first prompt you for a filename and than save it. The picture will not be crunched, so if you want to crunch it you must load it in to Deluxe Paint or another paint program and save it from there. DIRECTORY TO PRINTER ALT/CTRL D ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will ask for a directory to list to the printer. The directory can be any directory/disk and the output can be directed to any file or device. The printer mode will also be asked for, and if just an ASCII file is wanted, select the NORMAL gadget. AUDIO FILTER ON/OFF ALT/CTRL and * (keypad) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will toggle the amiga's audio filter on and off. The power led will indicate the state of the filter. Bright light for ON and dimmed light for OFF. 50/60Hz ON/OFF ALT/CTRL and / (keypad) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will toggle the screen from 50 to 60Hz. This only works on Amigas with the 'Super Fat Agnus' installed. (ECS) SCREEN SHUFFLER ALT/CTRL and CRSR UP ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ <WITH ACTIVATE> This will send the first screen to the back, and activate the first window on the screen that now have become the first screen. This function is absolutely necessary if you are doing any programming and debugging. If you are debugging a program, and have just called a function that have opened a screen, and the debugging program have it's own screen and the CLI-screen is open, you may never get back to the debugger screen without this utility. The left Amiga N/M functions will only toggle between the CLI-screen and the newly opened screen, and not the debugging tool's screen. If you understood that you will love this screen shuffler. I have used it a lot. SCREEN SHUFFLER ALT/CTRL and CRSR DOWN ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ <WITHOUT ACTIVATE> This will send the first screen to the back. No activating will be done, so you will have to activate a window yourself by clicking in the window to activate, with the mouse. WINDOW SHUFFLER ALT/CTRL and CRSR RIGHT ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Back to front. If you have more than one window on a screen, you can move the one at the back into the front and the other back to the back. This will work from within other Space II utilities, so you can get back windows that have come behind other windows (maybe windows without depth-gadgets) WINDOW SHUFFLER ALT/CTRL and CRSR LEFT ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Front to back. This will work from within other Space II utilities, so you can get back windows that have come behind other windows (maybe windows without depth-gadgets) TEXT RESCUER ALT/CTRL and ENTER (keypad) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If you have had a crash when you have been working with a text editor, program editor, Seka xxx, AsmOne or something that uses ascii text, you can use this utility to scan the memory and save the text. The only thing you must do is to include the following text in your texts. In the start of every sources, docs or texts you add the following: #RESCUE# This can be commented away like this: ;#RESCUE# Assembler (*#RESCUE#*) or {#RESCUE#} Pascal /*#RESCUE#*/ C If you include this in your sources, there is a chance that it can survive a GURU or some other kind of crashes. If you know what the first and last chars in your text are, you can also search after those. Example: *MyStart* . . . . . . *MyEnd* (If some text editors don't use ASCII 10 (Linefeed) as line separators, (AsmOne) you can find the start and the end of the text, and than convert ASCII 0 to ASCII 10.(EOF to LINEFEED)) When you activate the rescue option, the screen will flash to show you that something is going on, and when the text is found a requester will be displayed. You can no select a end-of-text marker and see if the size of the text found is the right size. If the size is right, you can now save the text found and than continue, or you can break the search. You can also interrupt the search by pressing the left mousebutton. SWITCH BLANKER MODE ALT/CTRL and . (Keypad) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will bring up a requester and you may choose from three types of blankers. - SPACE TRIP A bit prosessor sensetive. - LINES This also a bit prosessor sensetive. - BLACK SCREEN No processor time sensetive, good for multitasking. - 3D CLOCK A bit prosessor sensetive. - NONE NO blanking. - DIMMER Very good for intensive multitasking. ° The space trip mode will display a star field that travel towards you. You can now change the colours on the stars by creating a file called SPACE.COLOUR in the S: directory on your startup-disk. · The file must contain the definition of seven colours in the following format F4A,D48,B47,A45,824,623,522 · The format is 7 colours containing red,green,blue values for each colour F4A ^^^ |||_____Blue {0123456789ABCDEF} ||______Green {0123456789ABCDEF} |_______Red {0123456789ABCDEF} ^ ^ | | Dark Light · You don't have to delete this file to bypass the load colour function. Here is how you do it. You simply place a illegal char as the first char. Example: *F4a,D48,B47,A45,824,623,522 · And to reactivate the load colour function, you just delete the illegal char, and the colour that you have defined will be loaded. ° The Line mode (Kaleidoscope) will display a random set of lines. The lines will bounce around the screen making beautiful patterns. This mode is not good for heavy multitasking, but nice to look at! ° The Black Screen blanker will open up a small black screen. This mode requiers almost no processor time at all. Nice for multitasking with other 'heavy' tasks as raytracers. ° The 3D clock mode will display a wireframe clock, showing the current time. The clock will rotate randomly around the X, Y and Z axis. ° The colour dimmer is a more processor time friendly, it will use almost no processor time. This mode can be used when other tasks require as much of the 68000 as possible (Raytracers...) DISPLAY EXEC VECTORS ALT/CTRL and BACKSPACE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will display six of the vectors in the ExecBase. The six vectors are used by some viruses to link them self into memory and survive a warm reset. You can reset the vectors if you want to. The Vectors will also be checked each minute, and if they are non-zero the requester will be displayed. This can discover viruses that has been started from a program and linked it self into the vectors. Use the middle gadget to toggle On and Off the vector checking. DISPLAY BOOT-BLOCK ALT/CTRL and 4 (Keypad) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will display the boot-block on the disk in DF0 as a ASCII-dump. You could use this to check disks for bootblock viruses and to view the boot-block. INSTALL BOOT-BLOCK ALT/CTRL and 5 (Keypad) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will install a standard bootable boot-block on the disk in DF0. This is the same boot-block as the one you get by using the DOS command Install. UNINSTALL BOOT-BLOCK ALT/CTRL and 6 (Keypad) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will make the disk in DF0: unable to boot. KEYBOARD MACRO ALT/CTRL and M ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will display a requester and you can choose a key to make a macro on. The key must be one from the these {1 2 3 4 5 6 7 8 9 0}. When the macro is recording your keypresses, a sprite will be displayed. The recording can be stopped by pressing ALT/CTRL M. The size of the macro memory is 1024 bytes, so approx.. 256 keypress can be recorded. You can save your macros by selecting SAVE on the requester. The macros will be saved to the S: directory. If there is a delay for more then 1 second when recording, the delay will also be recorded, so the macro can be used with saving of files and then do something after the saving has completed. The macros can be nested into each other with no limitation. Some of the functions in the blanker can be used in the macros. Window and screen flipping can be used. For deleting a macro you can select a macro and record nothing. example: ALT/CTRL M, then macro 1, then ALT/CTRL M. NEWCLI ALT/CTRL and C ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will open a new CLI-window. You most have the NewCli and EndCLi commands in the C: directory. You close the CLI-window with the EndCli command. FONT VIEWER ALT/CTRL and F ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will open up a font requester and display a list of the available fonts. By clicking on a font name the font will be displayed in the centre box on the requester. DISK COPY ALT/SHIFT/CTRL DISK COPY ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will make a copy of a disk. This is a bit simple so only the DF0: unit is used for the copy. The trackdisk device is used, so it's not of the fastest copier around, but it works. (I've only got one drive.) DISK FORMATTING ALT/SHIFT/CTRL FORMAT ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will format a disk in the DF0: device. The data that was on the disk will be lost, so be careful. You can choose between the QUICK and the STANDARD mode. The QUICK mode will not format the whole disk, but only the root block. So if you have a completely unused disk, you should use the STANDARD mode to format the disk. This will initialize all of the sectors to the Amiga DOS format. ----------------------------------------------------------------------------- All of the functions should work one any legally opened intuition screen. It will not work on custom screens made by hacking with copperlists. All functions will make popup windows on the window you are currently working on. If the window has the NOCAREREFRESH bit set, some functions will not open up on that window, but on a normal window. To be sure that it don't crash, you should always close any windows that the SPACE program have opened one a screen that you want to close. If you close the program that 'own' that screen, you may never get to the windows that SPACE opened on that now closed screen. This may be fixed in later versions, by hooking onto the CloseScreen function in graphics.library. You need the 'reqtools.library' in the Libs: directory on your startup-disk to use this program. The 'reqtools.library' and the 'powerpacker.library' was written by Nico François (PowerPeak). I will send my greetings to this great amiga programmer !!!. Keep up the exellent work. ----------------------------------------------------------------------------- // AND REMEMBER THAT ONLY THE AMIGA MAKES IT POSSIBLE ! // // ...AND MONEY MAKES EVEN MORE POSSIBLE !!! \\ // \X/ SPREAD THE PROGRAM AND THE WORD